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The offices of Xerox Artificial Intelligence Systems in Pasadena 
will be closed starting Friday, December 25th and will reopen on 
Monday, January 4, 1988. From December 28th to December 
31st, the answering machines will be available to you from both 
toll-free numbers. Urgent problems will be handled as soon as 
possible. Please be sure to leave complete information about 
where and when we should return your call. 

All of us in AIS Customer Support would like to wish you a Happy 
Holiday Season! 

- Martha Burmeister, Ron Clarke, Judy Dering, Larry Harada, 
Lorraine Kiewiet, Marty Raim, Hugo Tafel, Susan Trautz, 
Greg Wexler 



Xerox AIS Customer Support 
250 North Halstead Street 
P.O. Box7018 

Pasadena, CA 91109-7018 
M/S 5910-432 



The following topics are covered in this issue: 

• Cannot boot Lisp volume after erasing Lispfiles 

• Lyric doesn't immediately release files on NS servers 

• XCL:storage-exhausted error 

• Saving BITMAPS 

• ADVISE not saved on file 

• Redefinition of an Interlisp function 

• Dwimify of I. S. OPRS 

• OUTPUT a free variable in Interlisp Exec 

• CL mapping functions 

• 1987 Index 



Terminology used in this HOTLINE! bulletin: 
UG - Users' Guide 

AR - Action Request, a Xerox problem tracking number (e.g. 
AR8321) 

IRM - Interlisp Reference Manual 
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BULLETIN 9.1 



Cannot boot Lisp volume after erasing Lispfiles 



Release 1186 Koto and Lyric 

Keywords MP 199, Booting Lisp, System Tool, Lisp microcode 

Problem Cannot boot Lisp volume from boot icons or System Tool after 
erasing Lispfile volume. 

Background On the 1186, the Lisp microcode file Lispdove.db is stored on the 
Lispfiles volume and is used during booting of a Lisp volume. If 
you have erased the Lispfiles volume from the System Tool 
because of hard disk errors or other reasons, this file will also be 
deleted and you will not be able to boot any Lisp volume. You will 
need to reinstall the Lisp microcode on the Lispfiles volume in 
order to boot Lisp again 

Symptom Attempting to boot Lisp volume from boot icons hangs at MP 1 99. 

Attempts to boot Lisp volume from System Tools results in 
message "No microcode found on Lispfiles." In addition, if you 
select Lispfiles from the Volume Menu in the System Tool and 
look at the Volume Boot File entry you will not see the entry 
"(System Files #1) Lispdove.db (filedate/time)." 

Workaround F2 boot the Installation Utility floppy. Select the option "Install Lisp 
Microcode Only" and you will then be prompted to insert the 
appropriate System Files floppy that contains Lispdove.db. If you 
are a Prolog user you must choose the menu option "Install 
Prolog Microcode!" after installing the Lisp microcode. Again, you 
will be prompted for the correct floppy. After the microcode has 
been loaded you will now be able to boot your Lisp volumes. 



References 1186 Users' guide, Lyric release - Software Installation, 
Reinstalling Microcode, pages 60-61 
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Lyric doesn't immediately release files on NS servers 



Release Lyric 

Keywords NS Server, CLOSEF 

Problem Lisp maintains a cache of hanciies on fiies it has deait with 
recently, so as to expedite subsequent operations, e.g., an 
INFILEP immediately followed by an OPENSTREAM for the same 
file. As long as Lisp has the handle, the file cannot be moved or 
deleted from another workstation. 



Symptom Write a file to an NS file server {e.g. COPYFILE, MAKEFILE, etc.) 

and try to move or delete this file from another 1108 or 1186 
using File Browser. Upon expunging the file, the system will take 
a while and a message appears at the FileBrowser prompt 
window: 

Couldn't expunge 

{File Server : Domai n :Org}<Di rectory>f i 1 ename 
No file expunged. 

After a Timeout period, the user can access the file. 

Workaround If you don't want to wait for the timeout period, before trying to 
manipulate . the file from elsewhere, at the IL exec call: 
(BREAK.NSFILING. CONNECTION host). 



References AR 9414 
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XCLstorage-exhausted error 



Topic XCL: storage-exhausted error and running out of symbol space 

Release Lyric 

Keywords storage-exhausted, 9322, symbol space 

Discussion The XCLstorage-exhausted error message does not necessarily 
indicate that there is no storage space remaining and virtual 
memory is full. This error can occur when there are free pages 
left in the main data space, but pages allocated to the litatom (or 
symbol) space are all used. 

The current limit on the number of symbols is 65,535. When this 
limit is reached, a 9322 error will occur. Prior to the 9322, the 
user is warned with a continuable error under 
\DOSTORAGEFULLINTERRUPT. The message "Serious 
condition XCLstorage-exhausted occured" will be posted in the 
break window. 

The InterLisp function ILSTORAGE.LEFT can be used to 
determine the cause of the storage-exhausted error. This 
function returns how much storage is left in the major data areas 
in the virtual address space. The last two numbers returned 
indicate the number of free pages left in the litatom space and the 
fraction of the total litatom space that is free. 

Users should note that symbols are generated during macro 
expansion. While running interpreted, generating thousands of 
SETFs in a loop can result in the symbol table filling up. If the 
code is compiled, the macro is expanded only once at compile 
time, and the symbol table will not grow noticeably. 



References IRM 22.2 - 22.5 
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Saving BITMAPS 



Release Lyric 

Keywords BITMAP, VARIABLES, VARS 

Problem BITMAPS cannot be saved with VARIABLES file manager 
command. 

Example In the XCL exec do the following: 

(DEFPARAMETER XXX ( IL : BITMAPCREATE 50 50)) 

Then call the bitmap editor, modify and save the contents of the 
bitmap. 

(IL:EDITBM XXX) 

When you call (IL:FILES?) you will be prompted to save XXX as a 
Common Lisp variable. When you call IL: MAKEFILE, the 
expression (DEFPARAMETER XXX (ILBITMAPCREATE 50 50)) 
will be written to the file, but the contents of the bitmap will not be 
saved. 

Symptom When the source file is loaded, the variable will be defined as an 
empty bitmap. 

Workaround Use the VARS command to save a Common Lisp variable whose 
value is a bitmap. 

For example, in the XCL exec use: 

(SETQ IL:FOOCOMS *((IL:VARS XXX))) 

to save the variable XXX (in the current package) on the file with 
the rootname FOO. 

Reference AR 9390, Lyric Release Notes, page 45. 
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ADVISE not saved on file 



Release Lyric 



Keywords ILADVISE, ADVICE, XCLADVISE-FUNCTION, File Manager 

Problem Fiie Manager piaces ADviSE ahead of FN3, and so loses the 
advice upon loading file. 



Example In the case where you would want to put some advice and the 
function definition on the same file, (FILES?) prompts first for 
advice to save, then for FNS and VARS (going in alphabetical 
order). When MAKEFILE is called and the file is then loaded into 
a fresh sysout, the ADVICE or ADVISE to the function is installed 
first, and since there is nothing to advise at that point, it loses. 
For example: 

(DEFINEQ( JUNK (X Y)(IPLUS X Y] 

(ADVISE 'JUNK 'BEFORE ' (PRINT "This is my debugging filter 
for JUNK"] 

Then call (FILES?) and MAKEFILE. Load the file and the advice 
won't work. 



Workaround Install the ADVISE as P statement in the COMS, after the FNS 
definition. For example: 

(SETQ F0OC0MS '((FNS JUNK) (P (ADVISE 'JUNK ' BEFORE '(PRINT 
"ONCE"))))) 

or: 

(SETQ FOOCOMS '((FNS JUNK)(P ( XCL : ADVISE-FUNCTION 'JUNK 
'(PRINT "ONCE") '(.-WHEN .-BEFORE))))) 



Reference AR 9441 

IRM Vol. II, 15.11 

Xerox Common Lisp Implementation Notes, pages 106-109 
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Redefinition of an interiisp function 



Release Lyric 

Keywords UN3AVEDEF 

Example A customer asked the following question: Is the old definition still 
supposed to be saved on EXPR property if an InterLisp function is 
redefined? 

For example, in InterLisp executive: 

(DEFINEQ (IL-REDEFINE-EX AMPLE NIL (PRINT "FIRST 
DEFINITION" ) ) ) 

and then: 

(DEFINEQ (IL-REDEFINE-EX AMPLE NIL (PRINT "SECOND 
DEFINITION" ) ) ) 

When the user did: 

(UNSAVEDEF ' IL-REDEFINE-EXAMPLE) 

it returns: 

"nothing saved" 

The DFNFLG was set to NIL. This is a change in behavior from 
Koto and previous releases. 

~rt . .u . j-u _ i minn i *~ +u« ,j„t:„:4-;„., 

i lie user ouuiu use nits uuiiiiiiciiiu iu icaiuic mc uc hum. 



Workaround Explicitly save the old definition (for example, with SAVEDEF). 
Reference AR 9349 
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DWIMIFY of I. S. OPRS 



Release Lyric 



Keywords I.S.OPR , DWIMIFY 



Topic User-defined i. S. OPkS are not automaticaiiy dwimified. 



Discussion CLISP infix forms no longer work under Lyric. Using DWIMIFY in 
Koto on most CLISP code automatically makes the correct 
translation. However, users that have defined their own I.S.OPRS 
which use the assignment operator (<-) must explicitly modify the 
definitions. 

Example In Koto, 

(I.S.OPR 'IS NIL '(eachtime I.V. «- BODY)) 
allows you to write (for A in B as C is (CAR A) do ...). 
In Lyric you have to change that to: 

(I.S.OPR 'IS NIL '(eachtime (SETQ I.V. BODY)) 

The errors which occur from failing to make such a translation 
can be subtle. 



Reference Lyric Release Notes, pages 36-38. 
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OUTPUT a free variable in Interlisp EXEC 



Release Lyric 
Keyword ILOUTPUT 

Probiem OUTPUT, which was unbound in Koio and previous reieases, is 
now used globally in the InterLisp EXEC and may no longer be 
used globally by the user. 

Example A user has used INPUT and OUTPUT as scratch variables when 
setting up streams to hand to programs at the EXEC. In Lyric, 
since OUTPUT is a free variable in the Lyric INTERLISP EXEC (in 
XCL:EXECA0001) it will cause a number of undesireable side 
effects if rebound. 



Workaround Use other Execs, or choose another scratch variable name. 
Reference AR 9432 



AIS CUSTOMER SUPPORT 



HOTLINE! 



BULLETIN 9.9 



CL mapping functions 



Release Lyric 

Keywords ckmapcar, c!:map!ist, c!:mapc, cl:mapl, cl:mapcan, chmapcon 

Example The Common Lisp mapping functions fail to return if one of the 
lists given is circular. The expected behavior is that "the iteration 
terminates when the shortest list runs out, and excess elements 
in other lists are ignored." CltL page 128. 

In the XCL exec: 

(SETQ *PRINT-CIRCLE* T) 

(SETQ LINEAR-LIST (LIST 'A ' B 'C)) 

(SETQ CIRCULAR-LIST (NCONC LINEAR-LIST LINEAR-LIST) ) 
(MAPCAR #' (LAMBDA (X Y) (PRINT (LIST X Y) ) ) 
LINEAR-LIST CIRCULAR-LIST) 



Symptom The system will hang with the cursor indicating intermittent 
garbage collection. 



Workaround A patch file is currently being tested. 



Reference AR 9420 
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1987 INDEX 



HOTLINE! index by Issue: Bulletins 1 through 9 



Bulletins (1.1) RS232 Chat 

(1.2) SETQ and the File Manager 

(1.3) Default MAKEFILE Environment 

(1.4) Changing a saved file's Reading Environment 

(1.5) SEdit and multiple Edit Date Fields 

(1.6) MP 9303 on rebooting a partition 

(1.7) Break, Font not found 

(1.8) Sketch and Hardcopying data 

(1.9) HORRIBLEVARS 

Bulletin #2 (2.1 ) Silent failure of MAKEFILE 

(2.2) Unbound atom in Browser 

(2.3) Control-C Break in TOPS-20 TCP Chat window 

(2.4) Koto-Lyic readtable inconsistency 

(2.5) MP 0915 recovery on booting Systemtools 



Bulletin #3 (3.1) How to close open streams 

(3.2) Saving macros in files 

(3.3) NAME COMMANDS spontaneous redefinition 

(3.4) Interfacing an 1 1 86 to a VAX 1 1/780 and Sun 3/1 60 

(3.5) Exporting Symbols from Packages 

(3.6) Making Tedit Read Only 

(3.7) Over-riding the default compiler 

(3.8) Changing the Default Executive type 



Bulletin #4 (4.1) Using the left cluster keys in SEdit 

(4.3) Changing Levels in SEdit 

(4.4) Function Keys in SEdit 

(4.5) Changing Fonts in SEdit 

(4.7) Setting a Default Mode for SEdit 

(4.8) Finding "?" in SEdit 

(4.9) Changing the Print Case in SEdit 

(4.10) Macros in SEdit 

(4.11) SEdit DO-IT Key Does not Work as Documented 



Bulletin #5 (5.1) Creating and interning symbols 

(5.2) Accessing symbols in packages 

(5.3) Packages and Readtables 

(5.4) Difference between MAKE-PACKAGE, IN-PACKAGE 
and DEFPACKAGE 

(5.5) Exporting symbols using DEFPACKAGE 

(5.6) Building a file that exports on loading 

(5.7) Creating and interning symbols 

(5.8) Package prefix for symbols and their values 

(5.9) Exporting symbols in name-conflict 

(5.10) Importing symbols that have name conflict 

(5.11) Deleting a package 
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HOTLINE! Index by Issue: Bulletins 1 through 9 



Bulletin #6 (6.1) COPYFILE to floppy LOGXOR break 

(6.2) Error when installing a sysout from floppy: "File name not 
found" 

(6.3) Error when installing a sysout from floppy: "Floppy label 
error" 

(6.4) Disk scavenging 

(6.5) How to recover from internal garbage collection table 
overflow 

(6.6) How to diagnose the cause of internal garbage collection 
table Overflow 

(6.7) LOGOUT resets the TTY parameters 

(6.8) Open RS232 stream 

(6.9) Using the left cluster keys in SEDIT 

(6.10) Changing fonts in SEDIT 



Bulletin #7 (7. 1 ) Koto 1 1 86 MakeScript bug 

(7.2) Standalone password protection 

(7.3) "File System Resources Exceeded" 

(7.4) Loading SYSEDIT without MASTERSCOPE 

(7.5) The side effect of aborting a SYSOUT procedure 

(7.6) TCP FTP transmission problem of LCOM and DFASL files 

(7.7) Unbound atom problem in TCP 

(7.8) TCP Chat problem to UNIX 4.3 hosts 

(7.9) TCP Trivial File Transfer problem 



Bulletin #8 (8.1) Porting Common Lisp files to Lyric 

(8.2) Compiling non-Xerox Common Lisp files in Lyric 

(8.3) XCLEXEC Window Property bug 

(8.4) XCL:ADD-EXEC Window Property bug 

(8.5) Restoring Multiply Advised Functions 

(8.6) Interpreted and Compiled Macros 



Bulletin #9 (9.1) Cannot boot Lisp volume after erasing Lispfiles 

(9.2) Lyric doesn't immediately release files on NS Servers 

(9.3) XCL: storage-exhausted error 

(9.4) Saving BITMAPS 

(9.5) ADVISE not saved on file 

(9.6) Redefinition of an InterLisp function 

(9.7) Dwimify of I. S. OPRS 

(9.8) OUTPUT a free variable in InterLisp Exec 

(9.9) CL Mapping functions 



1987 Index 
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HOTLINE! Index by Subject: Bulletins 1 through 9 



Subject Page Number 

A ADD-EXEC (XCL function) 8.4 

Advice 

Multiple advice 8.5 

Saving 9.5 

B Bitmap 

Saving 9.4 
C Chat 

RS232 1.1 
TCP (see TCP) 

Common Lisp 

Porting source files 8.1 

Compiler 

Default 3.7 

Non-Xerox source files 8.1, 8.2 

COPYFILE (IL function) 

To floppy 6.1 

Cursor Codes (see MP Codes) 

D DEFPACKAGE (CL function) 5.4 
DWIMIFY 

I.S.OPR 9.7 
E Exec 

Default 3.8 

Window property 8.3 

F Fonts 

Not found on NS server 1 .7 

G Garbage Collection 

Overflow 6.5, 6.6 

H HORRIBLEVARS (command) 1.9 

I IN-PACKAGE (CL function) 5.4 

I.S.OP 

DWIMIFY 9.7 
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Subject Page Number 

M Macros 

Compiled vs. interpreted 8.6 

Saving 3.2 

SEdit 4.10 

MAKEFILE (IL function) 

Default environment 1 .3, 1 .4 

Failure 2.1 

MAKE-PACKAGE (CL function) 5.4 

MakeScript 7.1 

Mapping Functions (CL) 

Circular list failure 9.9 

MP Codes 

0199 9.1 

0915 2.5 

9303 1.6 

9305 1 .8 

9322 9.3 

N NAME (command) 3.3 
NS Server 

File handle timeout 9.2 

Fonts not found 1.7 

O OUTPUT (IL variable) 9.8 

P Package 5.3 

Creating symbols 5.7 

Deleting 5.11 

Exporting symbols 3.5, 5.6 

Name conflicts 5.9 
Importing symbols 

Name conflicts 5.10 

Interning symbols 5.1, 5.7 

Prefixes 5.8 

Password 7.2 

R Reader Environment 1 .4 
Package (see Package) 

Fteadtable 2.4, 5.3 

RS232 
Cabling 

Sun 3/160 to 1186 3.4 

VAX to 1186 3.4 

Chat 1.1 

Streams 6.8 

TTY 6.7 
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HOTLINE! Index by Issue: Bulletins 1 through 9 



Subject 

S Scavenging 

SEdit 
Case 
Date field 
DO-IT key 
Default mode 
Find 
Fonts 
Keys 
Levels 
Macros 

SETQ (special form) 

Sketch 

MP 9305 error 

Storage-exhausted 
MP 9322 error 

Streams 
Closing 

Sysedit 

Sysout 
Aborting 

Load from floppy errors 

SystemTools 

MP 0199 error 
MP 0915 error 

T TCP 

Chat 
FTP 

TOPS-20 
TFTP 

Unbound variables 
UNIX 

TEdit 

READONLY property 

TTY (see RS232) 

U UNSAVEDEF (IL function) 



Page Number 

2.5, 6.4, 7.3 

4.9 

1.5 

4.11 

4.7 

4.8 

4.5, 6.10 

4.1, 4.4, 6.9 
4.3 

4.10 

1.2 
1.8 

9.3 

3.3 
7.4 

7.4 

6.2, 6.3 

9.1 
2.5 

2.3 
7.6 
2.3 
7.9 
7.7 
7.8 

3.6 
9.6 
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